Skip to content

docs: readme 설명 보완 nginx.conf 수정 시 inode 유지 - #113

Merged
MZC-CSC merged 1 commit into
developfrom
docs-admincli-nginx-timeout-inode
Nov 9, 2026
Merged

MZC-CSC merged 1 commit into
developfrom
docs-admincli-nginx-timeout-inode

Conversation

@MZC-CSC

@MZC-CSC MZC-CSC commented Nov 9, 2026 •

Copy link
Copy Markdown
Owner

배경

README / README_kr Known Issues 에 "504 가 계속 나면 proxy_read_timeout 을 올리고 reload" 절차를 넣었는데, 실행 중 nginx.conf 를 sed -i 로 고치는 방식이었습니다.

docker-compose.yaml 402행에서 이 파일은 nginx 컨테이너에 단일 파일 bind mount 됩니다.

- ./container-volume/mc-iam-manager/nginx/nginx.conf:/etc/nginx/nginx.conf:ro

sed -i 는 새 파일을 만들어 교체(inode 변경)하므로 컨테이너는 옛 inode 를 계속 보고, nginx -s reload 해도 반영되지 않습니다. 11-09 stage 반영 때도 cat 임시파일 > nginx.conf(inode 유지) 후 reload 로 처리했습니다.

변경

  • README.md / README_kr.md "Web Console 504" 절차
    • 2단계: sed 결과를 임시 파일로 만든 뒤 cat > nginx.conf 로 덮어써 inode 유지 → nginx -t && nginx -s reload
    • 3단계(추가): docker exec mc-iam-manager-nginx nginx -T | grep proxy_read_timeout 로 적용값 확인
    • 참고(추가): 단일 파일 bind mount 이유 설명, 이미 sed -i 로 고쳤다면 reload 대신 docker restart mc-iam-manager-nginx
  • 템플릿(nginx.template*.conf)은 이미 120s 라 변경 없음

실행 중 nginx.conf 는 nginx 컨테이너에 단일 파일 bind mount 되어 있어
sed -i 로 수정하면 inode 가 바뀌어 reload 해도 반영되지 않는다.
수정본을 cat > 로 덮어써 inode 를 유지한 뒤 reload 하도록 절차를 바꾸고,
nginx -T 로 적용값을 확인하는 단계와 sed -i 를 이미 쓴 경우 restart 안내를 추가한다.
@MZC-CSC MZC-CSC changed the title docs: nginx.conf 수정 시 inode 유지 방법 안내 (504 Known Issues) docs: readme 설명 보완 nginx.conf 수정 시 inode 유지 Nov 9, 2026
@MZC-CSC
MZC-CSC merged commit a181fc4 into develop Nov 9, 2026
1 check passed
@MZC-CSC
MZC-CSC deleted the docs-admincli-nginx-timeout-inode branch November 9, 2026 07:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants